home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu168a.dms / pu168a.adf / ReadMe < prev    next >
Text File  |  1978-01-13  |  9KB  |  362 lines
  1. Demo version  (as of 27Nov1991)
  2. ------------
  3.  
  4. This is the DEMO version of RayDance 1.0.  It is fully functional in
  5. all areas but two:
  6.  
  7. o  Aproximately every 15 minutes of rendering time a requestor
  8.    will appear prompting you to click to continue rendering.
  9.  
  10. o  The total number of polygons and spheres in a scene is limited
  11.    to aproximately 1400.
  12.  
  13.  
  14. File list:
  15. ---------
  16.  
  17. Several files are present on this disk.  All files ending with a .lzh
  18. are archives.  To use them you will need to decompress them using lharc.
  19.  
  20. o  README
  21.  
  22. o  COPYRIGHT
  23.  
  24. o  demo.lzh
  25.  
  26. o  demo_nofp.lzh
  27.  
  28. o  scripts.lzh
  29.  
  30. o  textures.lzh
  31.  
  32. o  objects.lzh
  33.  
  34. When unarchived (with lharc) the following files are will be found:
  35.  
  36. o  demo.lzh
  37.      RayDance.demo
  38.      RayDance.demo.info
  39.  
  40. o  demo_nofp.lzh
  41.      RayDance.demo.nofp
  42.      RayDance.demo.nofp.info
  43.  
  44. o  scripts.lzh
  45.      misc. script files
  46.  
  47. o  textures.lzh
  48.      misc. texture and bump maps
  49.  
  50. o  objects.lzh
  51.      misc. objects
  52.  
  53.  
  54. Two executables are provided:
  55.  
  56. o  RayDance.demo - this version requires 68020/68030 and 68881/68882
  57.    hardware.
  58.  
  59. o  RayDance.demo.nofp - this version will run on any Amiga with at
  60.    least 1 meg of ram.  Note however that most scripts will require
  61.    more ram.
  62.  
  63.  
  64. Other files
  65.  
  66. o  RayDance.setup - a RayDance default parameter file for hard disk
  67.    based systems.
  68.  
  69. o  RayDance.floppy.setup - a RayDance default parameter file for
  70.    floppy based systems.
  71.  
  72.  
  73. Hard-disk Installation:
  74. ----------------------
  75.  
  76. Create a drawer (directory) named RayDance_Demo on your hard disk
  77. for the RayDance files to reside in.
  78.  
  79. Within this drawer create three sub-drawers:
  80.  
  81. o  Scripts
  82.  
  83. o  Textures
  84.  
  85. o  Objects
  86.  
  87. Place the script, texture, and object files into the appropriate
  88. drawers.
  89.  
  90. Copy either of the two executables into the RayDance_Demo drawer.
  91.  
  92. Copy RayDance.setup to the s: directory.
  93.  
  94.  
  95. Floppy Installation:
  96. -------------------
  97.  
  98. Format two floppies and label them
  99.  
  100.   o  RayDanceDemo:
  101.  
  102.   o  RayDanceDemo2:
  103.  
  104. On the RayDanceDemo: floppy create the following drawer:
  105.  
  106.   o  Scripts
  107.  
  108. On the RayDanceDemo2: floppy create the following drawers:
  109.  
  110.   o  Textures
  111.  
  112.   o  Objects
  113.  
  114.  
  115. Place the script, texture, and object file into the appropriate
  116. drawers.
  117.  
  118. Copy either of the two executables into the RayDanceDemo: disk.
  119.  
  120. Copy RayDance.floppy.setup to RayDanceDemo:RayDance.setup
  121.  
  122.  
  123. Running RayDance from workbench:
  124. -------------------------------
  125.  
  126. Open the drawer (or disk) containing the RayDance files.  Double
  127. click on the RayDance.demo icon.  After a few seconds (floppies will
  128. be much slower) the RayDance command window should appear (if your
  129. workbench screen is interlaced both the command and message windows
  130. will appear).
  131.  
  132.  
  133. Check the texture path and object path strings.
  134.  
  135. Paths for hard disk systems:
  136.  
  137.   Texture path  -  Textures
  138.  
  139.   Object path   -  Objects
  140.  
  141. Paths for floppy disk systems:
  142.  
  143.   Texture path  -  RayDanceDemo2:Textures
  144.  
  145.   Object path   -  RayDanceDemo2:Objects
  146.  
  147. If the path  strings do not specify the directories where the texture and
  148. object files are located the example scripts will not run.
  149.  
  150.  
  151. Use the PRESETS menu to select the 160x100 size.
  152.  
  153. Click on the script file disk icon on the command window.  A file
  154. requestor should appear.  The directory should be Scripts and the
  155. supplied example scripts should be displayed.  Select the script file
  156. 'grail.art' (RayDance scripts end with a .art suffix by convention) by
  157. double clicking on it or click once on the file name then click the USE
  158. gadget.
  159.  
  160. Click on the RENDER gadget.  The message window should come to the
  161. front and show some messages.  After a short while the preview window
  162. should become active and you will see the picture RayDance is
  163. generating.
  164.  
  165. The file  artwork.iff24 should appear in the ram disk.  This is an
  166. IFF24 file and may be displayed by any program that supports IFF24
  167. format.
  168.  
  169.  
  170. Running RayDance from the CLI:
  171. -----------------------------
  172.  
  173. RayDance REQUIRES A STACK OF AT 25000 BYTES.  Use the STACK command
  174. to check the current stack space.  Type
  175.  
  176.   STACK
  177.  
  178. if there are more than 25000 bytes you are ok.  If not type
  179.  
  180.   STACK 25000
  181.  
  182. to enlarge the stack.  If there is insufficient stack space RayDance
  183. will tell you so on the message window.
  184.  
  185. To start RayDance from a CLI you should cd to RayDance's directory
  186. (drawer) then type
  187.  
  188.   RayDance
  189.  
  190. RayDance should then load after proceed the same as if it were being
  191. run from the workbench.
  192.  
  193.  
  194. Help system:
  195. -----------
  196.  
  197. Help for the user interface gadgets and displays can be obtained by
  198. activating the window you are interested in, moving the moush to point
  199. at the object of your curiosity then press the HELP key.
  200.  
  201. Alternatively use the HELP item on the project menu.
  202.  
  203.  
  204. Script syntax:
  205. -------------
  206.  
  207. There isn't space here to cover the script language completely (the
  208. manual for the 'full' version of RayDance is over 200 pages) but here
  209. are some fundamentals:
  210.  
  211. Comments start with an exclamation mark and extend to the end of line.
  212.  
  213. Input is free-form.  Statements can be on one, two, or more lines
  214. with an arbitrary amount of white space (blanks, tabs, newlines)
  215. between each component of a statement.
  216.  
  217. Variables:  Variables can be one of the following types,
  218.  
  219.   Integer, Real, Complex, Vector, and Matrix
  220.  
  221. Values:
  222.  
  223.   Examples of integers:   1  4  12345  -784
  224.  
  225.   Examples of reals:   1.0  2.98  -0.0029947  .3  -.05
  226.  
  227.   Examples of complex:   1+2i  4-6i  -.2+1.7i
  228.  
  229.   Examples of vectors:  [1,2,3]   [.2,.55,100.983]
  230.  
  231.   Examples of matrices:  [1,2,3,4,5,6,7,8,9]
  232.  
  233. Operators:
  234.  
  235.   + - * /
  236.   % (modulus)
  237.   . (vector dot product)
  238.   # (vector cross product or vector transformation by a matrix)
  239.   | vector |  (vector length)
  240.  
  241. Basic scene elements:
  242.  
  243.   Sphere, polygon, or quadric surface
  244.  
  245. Internal object generation:
  246.  
  247.   LATHE  (surface of revolution)
  248.   EXTRUDE
  249.   MESH   (2d array of points interconnected by triangles)
  250.   TREE
  251.   LANDSCAPE (terrain generator)
  252.   MANDELBROT (mandelbrot mountain generator)
  253.  
  254.  
  255. Memory usage:
  256. ------------
  257.  
  258. RayDance is not a small program and 3d graphics tend to require lots
  259. of memory anyway.  You will need a MINIMUM of 1 meg ram to operate
  260. RayDance.  If you have only 1 meg and you getting out of memory errors
  261. then try the following:
  262.  
  263.   o  If the render starts ok but fails part way through try changing
  264.      the picture file location from ram: to a disk.
  265.  
  266.   o  For especially tight memory rendering the preview window can be
  267.      disabled freeing up the memory required by the 320x400 HAM window.
  268.  
  269.  
  270. Example pictures:
  271. ----------------
  272.  
  273. Also included are HAM version of some pictures created by RayDance.
  274.  
  275.  
  276. Thankyou and happy rendering:
  277. ----------------------------
  278.  
  279. You should now be started using the demo version of RayDance.
  280. Experiment with picture sizes.  Try the antialiasing.   I hope you
  281. find the unique capabilties of RayDance useful.
  282.  
  283. Many thanks from
  284.  
  285. Charlie Comstock  owner/programmer
  286.  
  287. Radiance Software
  288. 2715 Klein Rd.
  289. San Jose, CA 95148
  290. (408) 270-7420
  291.  
  292.  
  293. Order info:
  294. ----------
  295.  
  296. The complete RayDance package includes a 200+ page manual and 4 disks.
  297.  
  298. To obtain it check with your local dealer.  If your dealer doesn't have
  299. it and won't/can't order it for you RayDance can be ordered directly from
  300. Radiance Software.
  301.  
  302. When ordering directly from Radiance Software include full payment (including
  303. applicable tax, handling, and/or shipping charges) and send to:
  304.  
  305. Radiance Software
  306. 2715 Klein Rd.
  307. San Jose, CA 95148
  308.  
  309. (408) 270-7420
  310.  
  311. Current pricing for RayDance 1.0 is $99.95 (US dollars) including shipping
  312. (1st class priority mail) within the US and Canada.  California orders
  313. please include $8 sales tax.
  314.  
  315. Payment should be check or money order for US dollars, sorry no credit
  316. cards.  Shipment may be delayed until your check clears.  For faster
  317. shipment send a money order or cashier's check.
  318.  
  319.  
  320. Foreign orders:
  321. --------------
  322.  
  323. NOTE: The manual, control screens, and script language are in ENGLISH.
  324.  
  325. Payment should be easily negotiable in the US and should be in US dollars.
  326. Checks drawn on US banks are preferred.  Canadian postal money orders are
  327. also good.  If I have trouble cashing your check, shipment will be delayed.
  328. Any customs duties must be paid by the consignee.
  329.  
  330. Canada:
  331. -----------------------------------------------------
  332.       Standard shipping:  no charge  (1st class mail)
  333. Check from non-USA bank:  $15 handling charge
  334.  
  335.  
  336. England, Germany, France, Holland, Belgium, etc:
  337. -----------------------------------------------------
  338.       Standard shipping:  $20  (airmail)
  339. Check from non-USA bank:  $15 handling charge
  340.  
  341. Japan:
  342. -----------------------------------------------------
  343.       Standard shipping:  $20  (airmail)
  344. Check from non-USA bank:  $15 handling charge
  345.  
  346.  
  347. Shipping via Federal Express or other carriers is discouraged but is
  348. available for a $25 additional shipping charge.  This brings shipping
  349. for Canada to $25, for Europe to $45, and for Japan to $45.  If you
  350. send a cashier's check it may be worth it.  If not your order can not
  351. be shipped until your check clears.
  352.  
  353.  
  354. Other destinations: Please call or write for shipping charges and delivery
  355. methods.  Sorry but Radiance Software can not accept orders for
  356. destinations that require special permits or export licenses, such as China,
  357. Iran, Iraq, Libya, etc.
  358.  
  359.  
  360. Radiance Software reserves the right to change shipping, handling, and
  361. other charges without notice.
  362.